home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 November / Macworld (1999-11).dmg / Shareware World / Info / For Developers / Smile1.6.6.sea / Smile1.6.6 / Smile ƒ / Help files / File menu < prev    next >
Text File  |  1999-08-01  |  7KB  |  141 lines
  1. File menu
  2.  
  3.  
  4. New script ( N)
  5.  
  6. Select "New script" to open a new ("untitled") script window. Script windows have one of three colors (depending on preference setting, see "Preferences" dialog) and have built-in buttons on the bottom bar. Multiple script windows may be opened at the same time. For additional information, see Script window.
  7.  
  8.  
  9. New text (  N)
  10.  
  11. Select "New text" to open a new ("untitled") text window (white in color). "New text"  may be selected repeatedly to open any number of new text windows. For additional information, see Text window.
  12.  
  13.  
  14. Open... ( O)
  15.  
  16. Select "Open..." ("File" menu) to display the Smile open-file dialog box. Smile will open the following file types :
  17.  
  18. • script file ("osas" file type)
  19.  
  20. • applet, droplet
  21.  
  22. • text file ("TEXT" file type)
  23.  
  24. • SimpleText file ("ttro" file type)
  25.  
  26. • picture file ("PICT" file type)
  27.  
  28. • movie
  29.  
  30. • Smile dialog
  31.  
  32. • scriptable application (Smile will display its dictionary)
  33.  
  34. • scripting addition (osax) (Smile will display its dictionary)
  35.  
  36. If you select a file that Smile cannot open, you should hear a bip.
  37.  
  38.  
  39. Open dictionary...
  40.  
  41. Select "Open dictionary..." to open and display the dictionary of any scriptable application, including Smile, or of any scripting addition (osax). Only scriptable applications and scripting additions (osax) are selectable in the dialog. Applications that cannot be selected from menu are not scriptable. 
  42.  
  43. If you are not sure if a particular application is scriptable, use "Open dictionary..." and try to open it. If it opens, that application has the proper "resource" ("aete") amended, and is scriptable ; however, the extent of its scriptability is revealed only by comprehensiveness of its dictionary.
  44.  
  45. Dictionaries open in special text windows with a pop-up menu named "Index". This menu displays the list of the suites (bold, underlined), of the verbs (plain text) and of the classes (italics). Selection of any of these items will scroll the window to make it visible.
  46.  
  47. Smile includes a comprehensive dictionary that may be opened using the "Open dictionary..." menu as described above. However, it is easier to open the Smile dictionary from the Apple menu. 
  48.  
  49. For a summary of the Smile Dictionary, see Smile dictionary. 
  50.  
  51.  
  52. Close ( W) - Close all
  53.  
  54. "Close" closes the active window the same as clicking the close box. A prompt will be presented to save any changes that have been made. 
  55. If you press the Option key ( or alt) while you select "Close" (or you click the close box), Smile automatically closes all open windows of the same type as the front window.
  56.  
  57. ----------------------------
  58.  
  59.  
  60. Save ( S) - Save all
  61.  
  62. "Save" will save the changes of the active window to disk. If the window is a new window which has never been saved before, "Save" has the same effect as choosing "Save as …".
  63.  
  64. Press the Option key ( or alt) while you select "Save" for Smile to automatically save all open windows.
  65.  
  66.  
  67. Save as …  (  S)
  68.  
  69. When you choose "Save as …", a dialog lets you enter a new file name and choose a new destination. This dialog box also appears when you save a document for the first time.
  70.  
  71. The dialog box uses Navigation Services. You can define and use Prefered Items and use the Last Chosen Items. You can also use multiple selection. Note that this dialog is not modal : while it is opened, you can still switch to the other applications.
  72.  
  73. If the active window is a script window, the "Format" pop-up menu in the dialog box lets you choose to make a standard script file ("Smile document") or an applet / droplet ("Application"), with the options to make it stay-open and / or run-only.
  74.  
  75. A stay-open applet remains in the background after it has ended execution of its "run" (or unnamed) handler. This allows you to send requests to it, and receive responses. For instance, if the stay-open application has a handler 'on 
  76. DoSomethingRealCool()', you can run from another application (such as Smile, Script Editor or Hypercard for instance) : 
  77. ----------------------------
  78.  'tell application "MyStayOpenApplet" to DoSomethingRealCool()'.
  79. ----------------------------
  80. Such a 'tell' request can be sent by Smile from a Smile text or script window, or from a button or a dialog. 
  81.  
  82. A run-only applet is just an applet which does not contain its source script.
  83. CAUTION ! Before saving a script as run-only applet / droplet check its source script has been saved somewhere, or when you try to open it later, you will not be able to see its source.
  84.  
  85. For an introduction to applets, see Applets and droplets.
  86.  
  87. ----------------------------
  88.  
  89.  
  90. Page setup...
  91.  
  92. Selecting this menu item displays the standard page setup dialog box for the printer currently selected in the Chooser. 
  93.  
  94.  
  95. Print... ( P)
  96.  
  97. Selecting "Print..." displays the standard print dialog box for your printer. Clicking "Print" will initiate printing of the active Smile window. When printing texts or scripts, Smile prints the page number in the middle of the bottom of the sheet. 
  98.  
  99. ----------------------------
  100.  
  101.  
  102. Quit ( Q)
  103.  
  104. Select this menu item to quit the Smile application. A prompt will be presented if changes have been made to any open window. The "Worksheet" may be automatically saved depending on the preference setting, see "Preferences" dialog.
  105.  
  106. ========================================================
  107.  
  108. Advanced
  109.  
  110. • Almost each of the menu commands above can be scripted. Here are a few basic examples to get started.
  111. ----------------------------
  112. make new script window with properties {name:"Cool Script Window"}
  113. ----------------------------
  114. make new text window with properties {name:"Cool text Window"}
  115. ----------------------------
  116. tell window 1 to close it saving ask
  117. ----------------------------
  118. tell window 1 to save it in 0
  119. ----------------------------
  120. tell window 1 to save it in (new file)
  121. ----------------------------
  122. tell window 1 to print it
  123. ----------------------------
  124. (from a remote app) tell application "Smile" to quit
  125. ----------------------------
  126.  
  127. • The Open command will be best mimicked by the Smile handler "DoOpen" :
  128. ----------------------------
  129. DoOpen ( aPathName )
  130. ----------------------------
  131.  
  132. The Open dictionary relies on the Smile handler "dictionary":
  133. ----------------------------
  134. set theDictAsText to dictionary of file (thePathName)
  135. ----------------------------
  136.  
  137. • When you use the "Save" command on the window of an object script, you are only changing the object script of the object, but nothing is saved to disk until you save the object to disk.
  138.  
  139. ========================================================
  140.  
  141.